OpenBuildings™ Designer 帮助

定义编辑器

用于创建、保存、重命名和删除用户定义的数据组定义。

访问位置:
  • 后台:文件 > 数据集工具 > 定义编辑器
  • 目录编辑器:属性定义模式:右键单击 > 定义编辑器...


关于数据组定义

数据组定义(有时称为架构)用于帮助您使用和自定义数据系统,以便于创建标准和自定义参数目录以及目录项属性、值和特性。该系统还可以在使用放置工具和命令时将实例数据分配给各个目录项,并且可以管理和跟踪多种用途(包括报告和数据报表)的数据。

通常,数据组定义是一个目录(许多数据定义的集合),其中一个定义适用于每个目录项(如门和窗户)。各个目录项定义用于按名称和格式定义各个项特性(如门的防火等级)。

在定义编辑器中,部分定义和属性通过 OpenBuildings Designer 工具和实用工具来使用。除显示名称外,这些定义不能修改。它们以灰色文本显示。选择应用程序参考的定义和属性时,该对话框的工具和右键选项将被禁用。

“定义编辑器”工具栏

设置描述
新建定义文件 打开新建定义文件对话框。新元素/特性名称和目标目录文件位置是在此处创建的。


  • 目标 - 设置新建定义文件 (*.xsd) 的位置。
    • 组织 - 将位置设置为配置的组织层位置。
    • 工作空间 - 将位置设置为配置的工作空间(用户组)层位置。
    • 工作集 - 将位置设置到配置工作集(项目)层位置上。
    注释: 对于 COBie 模板,您将发现,其他选项数据集扩展: IFC数据集扩展:FM_Handover_Ext 可以设置为目标。
  • 文件名 - 用于命名新建定义文件 (*.xsd)。
  • 显示名称 - 用于输入要在适用的对话框中显示的定义名称。
注释: 在创建新的定义文件时,可以提前设置目标位置。该位置决定了数据集的访问控制级别。新建定义文件可位于其中一个预定义的目标位置。
与显示名称不同,文件名不应带有空格,但只能包含字母、数字、短划线、下划线和句点字符。也避免在显示名称中添加任何圆点字符。
新建特性组 在目录列表框中的激活目录位置处插入一个新建特性组。新建特性的缺省名称为 NewPropertyGroup。您可以通过选择右键单击 > 重命名来进行重命名。
新建属性 在目录列表框中的激活目录位置处插入一个新建特性。新建特性的缺省名称为 NewProperty。您可以通过选择右键单击 > 重命名来进行重命名。
验证 打开 数据组系统验证器 ,您可以在其中验证数据集并查看各个已验证项的状态。
保存 保存新元素和属性数据组定义(新建属性和属性组定义)。

定义树(左面板)

显示定义、定义目录、目录项和项实例。用于导航至并选择定义属性和属性组。选择用于确定相邻列表框中显示的信息。

设置描述
定义节点 选择根节点时,将列出激活数据集中可用的所有定义。

右键选项:

  • 新建定义文件 - 打开“新建定义文件”对话框。
  • 导出定义 CSV - 将所有定义导出到 Excel 文件 (*.csv)。*.csv文件将在 Excel 中自动打开并列出每个定义的定义名称、显示名称及 *.xsd 文件路径。标题为 “导出定义 CSV” 的信息对话框出现并显示已导出定义的数量和 *.csv 文件路径。
  • 导出定义属性 CSV - 将所有定义及其属性导出到 Excel 文件 (*.csv)。*.csv 文件将在 Excel 中自动打开并按层次列出所有定义及其属性;显示每个定义/属性的名称和显示名称,且显示每个定义的 *.xsd 文件路径。标题为“导出定义属性 CSV” 的信息对话框出现并显示已导出定义的数量和 *.csv 文件路径。
注释: 已导出的 *.csv 文件保留在缺省位置(激活工作集 ..\\Output 文件夹)。可离线使用 Excel 数据查看定义和显示名称,并根据需要在“定义编辑器”中进行修改。
定义节点 选定时,将列出定义中的所有属性组和属性。

右键选项:

  • 新建定义文件 - 打开“新建定义文件”对话框。
  • 新建特性组 - 在定义树中的激活位置处插入一个新建特性组。
  • 新建特性 - 在定义树中的激活位置处插入一个新建特性。
  • 属性 - 打开“属性”对话框,其中定义信息可用于所选的定义/属性组。仅显示名称可以在“属性”对话框中修改。
属性组节点 用于创建层次或定义属性组。与定义文件节点一样,选择属性组节点将列出定义属性和属性组,并显示相同的列数据。

其他的右键选项:

  • 重命名 - 重命名所选定义属性或属性组。选择目录项以激活编辑器字段。
  • 删除 — 确认后删除所选定义属性/属性组。删除属性组将移除其包含的所有属性。
属性节点 选定时,将列出所有定义属性及其值。右键选项包含此处提及的所有这些,除了属性菜单选项。

“属性”列表框(右面板)

将在此列表框中显示、创建和编辑定义、定义组和值。可以通过选择适用的单元激活编辑器字段、下拉菜单选项或弹出对话框来修改列和行中的信息。通过单击列标题可以对列进行排序。

例如,设置数据类型结构剖面缺省值可通过结构剖面选择器对话框来完成,该对话框在单击字段时打开。



缺省值设置的示例

注释: 二级对话框特定于定义编辑器,并在 OpenBuildings Designer 之外打开。它们的功能与其在 OpenBuildings Designer 中的等效对话框类似。
设置描述
定义显示

当在定义树中选择定义节点时,将显示以下列:

  • 显示名称 - 在数据组数据工具和实用工具中显示的名称。
  • 名称 - 为定义指定的名称。
  • 路径 - 列出定义 (.xsd) 文件位置。
注释:显示名称可编辑(单击显示名称字段)。
定义和定义组显示 当从定义树中选择定义属性组节点时,将在列中列出所有定义通用的属性。当从定义树中选择属性时,这些通用属性也被列为行。只要您创建新的属性,它们就会出现。
  • 名称 - 为属性或属性组指定的名称。
  • 显示名称 - 在数据组数据工具和实用工具中显示的名称。
  • 数据类型 - 定义如何为属性输入属性值。
  • 缺省值 - 在放置/修改后初始化使用定义属性的目录项时,属性的设置值。
  • 必需 - “打开”表示定义属性必须使用放置/修改时的值进行定义。
属性显示

当在定义树中选择属性节点时,将显示以下列:

  • 属性 - 列出所有定义属性。该列表根据所选的数据类型而有所不同。选择定义文件或属性组节点时,将列出所有定义通用的属性。
  • - 列出所有列出的定义属性的定义值。这些值可以通过单击值字段进行编辑。
状态栏 显示正在加载的当前项的状态。此外,还显示正在工具栏上或右键选项中选择的任务的描述。

列表框控件

以下“属性”列表框控件用于定义和组织定义和属性。自定义数据集的效果随后可以在参考这些定义的工具和实用工具中看到。
设置描述
数据类型和缺省值 属性数据类型用于定义如何为属性输入属性值。根据所选的数据类型,显示的属性会有所不同。例如,选择十进制数据类型将列出附加的分数属性。对于每个选定的数据类型,您可以通过单击下一个属性字段来设置缺省值。有关数据类型缺省值/输入选项以及其他属性(通过数据类型选择添加),请参见以下表格。
数据类型 数据集示例(属性组名称 - 工具名称 > 属性显示名称 值输入 其他属性
面积单位 建筑空间 - 空间 > 面积 | 规划(平方英尺) 输入值按“平方单位”进行处理。
  • 图案
布尔型 建筑门 - > 框架/尺寸 | 框架深度 通过复选框将父级墙体厚度与“是/否”值相匹配。
单元 Profile_Common - 装饰条 > 单元符号名称 通过“单元”对话框(单击属性值字段时打开)设置值。
分类 SpaceEnergyAnalysis - 空间 > 能耗分析 | 空间类型 通过“分类”系统弹出对话框设置值。
  • 系统类型
日期 通过从“日历”弹出对话框中进行选择来设置值(日期)。
十进制 CustomParamBMPElbow - 风管附件 > 标准角度 通常用于尺寸属性。通过在文本字段中输入十进制值来设置值。
  • 单位
  • 分数
  • 最小值
  • 最大值
  • 图案
整型 StairConstraints - 放置楼梯 > 最大竖板数 仅处理整数值。
  • 最小值
  • 最大值
  • 图案
列表 StructuralFramingCommon - > 结构光洁度 通过从包含一组定义选项的下拉菜单中选择来设置值。
  • 可扩展
  • 列表值
逻辑 通过从下拉菜单中选择来设置值 truefalseunknown
样式 防火处理类型 - 样式定义 通过“样式和类别选择器”对话框(单击属性值字段时打开)来设置值。
字符串 ObjectIdentity - 墙体 > ID | 批注 值可以是任何文本字符串,输入在文本字段中。
  • 最小长度
  • 最大长度
  • 图案
结构剖面 StructuralFramingCommon - > 剖面名称 通过“结构剖面”对话框(单击属性值字段时打开)来设置值。
URL ObjectManufacturer - 幕墙 > 制造 | URL 从下拉菜单中选择值。
  • 图案
体积单位 SlabQuantities - 数据报表 > 体积(净值) 值以“立方单位”显示。
工作单位 Penetration - 孔洞 > 尺寸 | 长度 使用激活工作单位处理输入值。
单元 对于“单元”数据类型,缺省值在“单元”对话框中进行设置。该对话框可在您单击缺省值字段时打开。使用单元库下拉菜单选择要从中选择单元的单元库。
分类 对于分类数据类型,缺省值在“分类”对话框中进行设置。该对话框可在您单击缺省值字段时打开。分类数据类型会添加系统类型属性,您可以通过从下拉菜单中选择分类系统来对其进行设置。此选择会在“分类”对话框中填充可用的建筑分类。使用搜索字段细化分类列表。
定义阶数 选择“属性”列表框中项上的右键单击 > 定义阶数(从“定义”列表中选择“定义文件”节点时)将打开“阶数”对话框。该对话框用于确定定义中属性的排序顺序。
  • 属性面板 - 列出在其所属的属性组中分类的目录项属性。单击分类可选择其中的所有属性。您还可以选择各个属性。同时激活上移/下移箭头按钮。
  • 上移/下移箭头 - 当在属性面板中进行选择时启用。
    • - 将所选属性上移至最顶层,同时保持所选属性顺序不变。
    • - 将所选属性向上移动一层。
    • - 将所选属性向下移动一层。
    • - 将所选属性下移至最低层,同时保持所选属性顺序不变。
  • A-Z - 按字母顺序对整个属性列表进行排序。首先对属性组进行排序,其次是其中的属性。
  • 确定 - 保存更改并关闭对话框。
  • 取消 - 取消更改并关闭对话框。
注释: 所做的更改保存在定义文件 (*.xsd) 中,可在用于访问定义的“建筑”工具中进行查看。
列表值 对于列表数据类型,值列表在“属性”列表框中创建,随后该列表框将填充属性值下拉菜单。选择列表数据类型将启用列表值设置。然后,您可以从列表中选择项来设置缺省值(提供 [无] 作为缺省值)。
  • (新建列表项) - 打开要在其中输入列表项的文本字段。按<Enter> 添加新建列表项行。
  • (删除列表项) - 删除所选列表项。
注释: 从列表中选择项来设置缺省值(提供 [无] 作为缺省值)。
样式和类别选择器 对于“样式”数据类型,缺省值在“样式和类别选择器”对话框中进行设置。该对话框可在您单击缺省值字段时打开。使用“类别”和“样式”下拉菜单选择样式定义。
图案属性(字符串) 对于字符串数据类型,图案属性用于设置文本字符串图案,该图案用于定义如何为任何适用的目录类型和项输入属性值。

例如,当目录项拥有称为“邮政编码”(输入 19341-1127 等数据)的属性时,将完成以下操作:

  1. “数据类型”属性值设置为“字符串”。
  2. “图案”属性值设置为 [0-9]{5}-[0-9]{4}

该字符串指定输入的图案属性值必须为两组字符,分别为一组 5 个字符和一组 4 个字符。每组字符必须由整数 0 到 9 组成,且两个字符集必须用短划线隔开。

该表达式进一步定义如下:
属性值 描述
[0-9] 字符集中只能使用整数 0 到 9。
{5}- 该字符集由 5 个字符加短划线组成。
[0-9] 字符集中只能使用整数 0 到 9。
{4} 该字符集由 4 个字符组成。
若输入不符合指定格式的值,则将使用目录定义的缺省值或重新使用上次使用的有效值。

在“定义编辑器”中设置文本字符串图案时,可以在“目录编辑器”和应用程序中使用的任何目录属性面板中输入图案值。

注释: 有关详细信息,请参见有关图案元素的 Microsoft XML 文档。
结构剖面 对于结构剖面数据类型,缺省值在“结构剖面选择器”对话框中进行设置(参阅上述“缺省值设置的示例”的图解)。该对话框可在您单击缺省值字段时打开。使用“浏览” [...] 图标选择和加载“结构剖面”文件,并通过选择所需的代码类型缩小选择范围。
首选单位 用于定义十进制数据类型属性的单位属性。单击单位值字段将打开“首选单位”对话框,您可以在其中从单位列表中进行选择。此处进行的选择将设置用于访问属性定义的所有工具和实用工具的单位显示。
键入: DG DEFEDITOR